home *** CD-ROM | disk | FTP | other *** search
/ Font Garden / Font Garden (Walnut Creek) (October 1995) (1995).iso / pc / macutils / graphics / sparkle2 / _docs_ / new_in24.2 < prev    next >
Encoding:
Text File  |  1995-06-19  |  41.2 KB  |  708 lines

  1. What's new in 2.4.2?
  2. • Bug fixes: 
  3.     In 2.4.1 the 68K version often didn't play. Damn uninitialized variable.
  4. • Now supports the .M15 and .M75 MPEG suffixes. Also uses a better guess for 
  5.     the frame rate when opening a movie with an invalid frame rate.
  6. • Revamped MPEG playback prefs dialog which removes obsolete options, adds a 
  7.     new option and is a little more cohesive.
  8. • Playback is slightly faster with half pixels off and about 7% faster with 
  9.     half pixels on. Essentially this means that the cost of using half pixels,
  10.     is not much more than the cost of not using it.
  11. • Under certain rare conditions in previosu versions, the color conversion 
  12.     tables were destroyed too soon and images were displayed in random 
  13.     colors. I hope I have now fixed this.
  14.  
  15. What's new in 2.4.1?
  16. • Yet more speed: 16bit playback is now more than THREE times as fast as 
  17.     it was. Playback of resized images is MUCH faster.
  18.     NOTE: Some of the code changes I made to get this speed may well cause 
  19.     the code to run slower on 68K macs. I am not going to work hard to 
  20.     maintain two code bases for PPC and 68K. All my effort is going into 
  21.     optimal PPC speed, with no concern for 68K.
  22.     As a result of the changes to make 16bit playback faster, two things are 
  23.     now a little different:
  24.     (a) 16bit display in 16bit-fast mode is now higher quality (and the same 
  25.     as the hybrid 16/24 bit option which will go away when I fix the 
  26.     playback prefs dialog)
  27.     (b) If you move the window across two screens image quality may be 
  28.     substantially reduced. I figure this doesn't matter much--you shouldn't 
  29.     do that anyway cause it causes so much slowdown.
  30.     People interested in speed may be interested in the following:
  31.     on my 7100/80 with an accelerated 24bit card, 40% (!!!!!) of time in 
  32.     24bit playback is now spent copying data to the screen. This is why we 
  33.     need PCI and a faster bus!!!
  34. • Now that I have some extra speed at my disposal, I have altered some of the 
  35.     internal code (parsing and IDCT) to correctly handle some of the most 
  36.     finicky details of the MPEG spec. The result is to slow the code down by 
  37.     about 5% but, under certain circumstances, to improve the quality of the
  38.     image somewhat. Now that I have the CPU to do a good job, I want to 
  39.     make the images Sparkel displays as good as possible, rather than the 
  40.     somewhat amateurish quality they have sometimes had.
  41. • Bug fixes to 2.4.0
  42.     * With 2.4.0 I switched to a new link system and forgot to weak link 
  43.     against SpeechLib. This caused problems for people without SpeechManager 
  44.     on their macs. Now fixed.
  45.     * The PPC assembly I was using to build a 24bit pixmap worked OK for my 
  46.     video card but built a pixmap incompatible with the HPV motherboard 
  47.     video on PPCs. This should now be fixed.
  48.     * There were a few typos in the PPC assembly I wrote for 2.4.0 resulting 
  49.     in occasionaly visual glitches in the image. These are fixed.
  50. • FINALLY: I now save the index Sparkle builds when it first opens an 
  51.     MPEG, saving the lengthy startup while the index is calculated. Along 
  52.     with this I now also allow a frame rate to be saved with the MPEG. This 
  53.     is especially useful for the common MPEGs floating around the internet 
  54.     that have been encoded with a non-standard MPEG rate like 6 or 8fps.
  55.     Along with this comes a new menu item under the edit menu for stripping 
  56.     the resource fork from an MPEG. Read the ReadMe 2nd file for why you 
  57.     might want to do this.
  58. • Command-Y is now a shortcut for the Set Frame Rate menu item.
  59. • In the past sometimes error messages were not reported to the user because 
  60.     of a design flaw in the Think Class Library which I use to handle that 
  61.     sort of thing. (Gee, thanks, Symantec.) I have made some patches to TCL 
  62.     to try to rectify this---hopefully now you will always get an error message
  63.     when something goes wrong (especially when opening files) rather than 
  64.     being left in the dark.
  65. • Backward realtime playback sometimes played frames out of order. No 
  66.     longer.
  67. • If both MPEG and QT movies were open and memory ran low, Sparkle could 
  68.     lock up. Fixed.
  69. • The user interface to the MPEGSplit app was slightly altered, to give better 
  70.     error message feedback, and to remove some confusion about what to do when 
  71.     an error occurs.
  72.  
  73. What's new in 2.4.0?
  74. • Bug fix: I made a dumb error in 2.3.4 or 2.3.5. The symptons varied 
  75.     depending on your machine but most commonly were that if you grew the 
  76.     document larger than a certain size the window would go blank.
  77. • Bug fix: If you did some fiddling with the MPEG prefs, swapping bit 
  78.     depths and such, you could get your windows to become munged. This bug 
  79.     has been around for a year or so and no-one ever reported it (you have to 
  80.     do a very precise set of things to trigger it) but now it's gone.
  81. • Speed boost: I did profiling of the PPC code and based on that made 
  82.     some changes to the C code, as well as moving certain loop routines into 
  83.     PPC assembly. The resultant code can be as much as twice as fast as 
  84.     Sparkle 2.3.5 if everything is right. But not everything is in PPC 
  85.     yet---I only had time to do what I thought were the most common cases. 
  86.     In particular only the 4x4 IDCT is in PPC, not the 8x8 IDCT, and
  87.     only 24bit display code is in PPC, not 8 or 16 bit code. 
  88.     Those will come in time. There are also some other major algorithmic 
  89.     modifications in the wings to boost speed, but those are further away.
  90.     Also going to PPC assembly has meant the app is now built with a crazy 
  91.     quilt of Symantec C++ versions 7, 8 and Toolserver. The point is that I 
  92.     am poised to switch to using the very high quality (and phenomenally 
  93.     slow) C/C++ compilers from say Motorola at some point in the nearish 
  94.     future. With luck these would give a speed boost that's reasonable and 
  95.     yet easily achieved.
  96.  
  97. What's new in 2.3.5?
  98. • I found that there are certain MPEGs floating around (examples are 
  99.     flower.mpg and byrncad.mpg) that are not unusually MPEG encoded.
  100.     Specifically they contain a B-frame as the second frame,  and it's not 
  101.     clear how the I-frame before that B-frame should be interpreted---as 
  102.     a past or as a future predictor. An MPEG like this would crash Sparkle,
  103.     now it does not. 
  104.     Be warned, however, that the MPEGs I've seen like this are not very well 
  105.     encoded---it seems that the encoder used shows a general lack of 
  106.     knowledge of how MPEG frames are re-ordered when decoding, so the 
  107.     resultant MPEG can be pretty awful in areas where there is a lot of 
  108.     video motion.
  109. • Bug fix related to releasing memory when Sparkle is closed.
  110. • Sparkle does not work when Aladdin Shortcut (an INIT like Boomerang) is 
  111.     installed. As far as I can tell, this is a problem with Shortcut. 
  112.     I wrote to Aladdin a long time ago asking about this and never received 
  113.     a reply. I then wrote a few days ago and have not received a reply. If 
  114.     you use Shortcut and want this fixed, complain to Aladdin and tell them 
  115.     to speak to me.
  116.  
  117. What's new in 2.3.4?
  118. • Misc bug fixes---mainly on rare occasions things were set up to 
  119.     trap to the debugger on an error. These situations are now 
  120.     invalidated for release builds.
  121. • MPEGSplitter 1.02 fixes:
  122.     * Code for testing if volumes were locked or not is now more robust.
  123.     * Code for selecting directories is more robust.
  124.     * Quite a bit faster.
  125.  
  126. What's new in 2.3.3?
  127. • Bug fix: Sparkle now runs OK without Speech Manager present (just like 
  128.     in 3.2.1 and earlier versions).
  129. • Bug fix: Sparkle was writing to memory location 4 during startup. 
  130.     The problem was some variables were being initailzed in the wrong 
  131.     order. This caused a message for people who had LOBE installed.
  132.  
  133. What's new in 2.3.2?
  134. • The new code for auto arranging windows when new files are opened 
  135.     wasn't quite correct. Now fixed.
  136. • Many people asked if I could return to picture based MPEG and QT 
  137.     encoding (as opposed to time based encoding). To satisfy everyone I 
  138.     now support both. To get time based encoding, choose a frame rate 
  139.     of zero when encoding MPEGs or movies. (On the latest versions of QT 
  140.     a frame rate of 0 is called Best in the popup list).
  141.     Also any frame rate is supported for MPEG encoding. Be aware, 
  142.     however, that by choosing a frame rate not supported by the MPEG 
  143.     standard you are creating an MPEG file that may not play on all 
  144.     MPEG decoders, especially those based on special purpose hardware.
  145. • QT encoding using a specified data rate (only possible with the Cinepak 
  146.     encoder) didn't work correctly. Now fixed. If you have a PowerMac I 
  147.     would recommend using this option.
  148.  
  149. What's new in 2.3.1?
  150. • The bug where opening some MPEgs gave an error -2014 is fixed.
  151. • Sound now works with looping.
  152. • MPEG encoder bugs fixed:
  153.     * For sources that are not a multiple of 16 in width and height, motion
  154.           vectors could go in the range between the real height/width and the 
  155.           height/width rounded up to a multiple of 16, which is not allowed by
  156.           the DIS. (Every other encoder I know also screws up this way, but we 
  157.           might as well get it right.)
  158.     * When skipping macroblocks in P & B pictures, DC DCT coefficients weren't
  159.          being reset to midgrey.
  160.     * When skipping macroblocks in P pictures, motion vectors were not being 
  161.         reset to zero.
  162.     * Half pixels now work again (by mistake I had disabled them in 2.3.0).
  163. • The code for auto arranging windows across screens when you open a new 
  164.     document has been changed. This new code is a little more flexible and 
  165.     I hope it'll be more likely to come up with optimal placements of new 
  166.     windows.
  167. • The progress bar now flips down automatically when you're encoding then
  168.     hides itself once encoding is done.
  169. • The way low memory situations are reported has been changed. This should 
  170.     work a little better with QT. Let me know if it behaves strangely.
  171. • Selecting portions of a movie is now supported. Select a portion of a 
  172.     movie using the shift key in conjunction with the mouse button or 
  173.     arrow keys. You can use a selection for two purposes:
  174.     * You can limit playback to within the selection.
  175.     * Only the selection will be used when creating a new QT/MPEG movie.
  176.  
  177. What's new in 2.3?
  178. • The MEG2Decoder had problem where it screwed up display of MPEGs that were 
  179.     not a multiple of 16 in width. Fixed
  180. • A serious problem with MPEGEncoding that often produced garbage MPEGs is 
  181.       fixed.
  182. • All encoding (QT and MPEG) is now done based on time. not frame number. 
  183.     This makes audio support much easier.
  184. • Preliminary audio support has been added for MPEGs. See the ``Readme Sound'' 
  185.      file for details.
  186. • Opening QT movies (especially long ones) is faster.
  187. • Some minor user interface tweaks.
  188. • Some cosmetic bugs fixed.
  189. • You can now choose the frame rate at which to play MPEGs and PICT 
  190.       pseudo-movies.
  191.  
  192. What's new in 2.2.3?
  193. • Bug fixes:
  194.     * Under certain circumstances an MPEG would stop playing just before the 
  195.       very last or first frame was displayed.
  196. • Speed tweaks.
  197.  
  198. What's new in 2.2.1?
  199. • Bug fixes:
  200.     * In very special circumstances (a slightly corrupt MPEG that was missing
  201.       a SequenceEndCode, I was writing a few bytes over the end of a memory 
  202.       block. This lead to crashes on 020/030 class macs.
  203.     * When encoding an MPEG, I (very stupid, I know) landed up aliasing the file
  204.       reference number associated with the MPEG file, then closing that 
  205.       fileReferenceNumber twice, something Apple warn is not a great idea.
  206.     * At startup if the user had a corrupt prefs file and tried to quit, 
  207.       Sparkle would crash---I was ForgetHandle()ing a resource handle. Grrr!
  208.     * Fixed Yet Another problem with the SC++ BEL macros. This one involved 
  209.       crummy Symantec code for testing if an object's on the stack that fails 
  210.       when threads are active.
  211.     * Was setting the bkPixPat of a window to NULL when closing it--dumb.
  212.     * Was disposing of a handle that was disposed of in some library code 
  213.       written by someone else. Taligent have a nice naming convention for 
  214.       libraries to prevent this sort of thing---it can't happen a moment too 
  215.       soon.
  216.     * Fixed a few anomalies I noticed in the way things are drawn on 1 and 2
  217.        bit screens (like anyone uses Sparkle on one :-) ).
  218. • Tweaks to make the progam feel snappier:
  219.     * Wherever I was calling FlushVol() to dump the disk cache to disk, I now 
  220.       do that asynchronously. Async IO is also used in a few other places. It's 
  221.       not yet used for reading files, but that will come.
  222.       Note that QuicKeys, for reasons that (I'll be charitable and not state my 
  223.       true feelings) make no sense to me, disables asynchronous IO so you won't 
  224.       see any effect. If you think this sucks, call CE Software and tell them.
  225.     * I now preload QuickTime stuff at startup to avoid latencies later when 
  226.       I need it.
  227.     * When building a PICT pseudo-movie, a much faster algorithm for 
  228.       scanning for the files of the movie is used.
  229.     * When displaying a PICT pseudo-movie, the disk should be accessed rather 
  230.       less often than before
  231. • MPEG encoding has been sped up. I have dropped the Berkeley 
  232.     encoding algorithms and used my own algorithms. (Where these are similar to 
  233.     the Berkeley algorithm, I use the same name simply for consistency.)
  234.     My algorithms are not only faster but produce slightly smaller files 
  235.     and use more elegant, shorter code---a perfect win win win situation. 
  236.     The Technical Readme file contains brief descriptions of the properties 
  237.     of the new algorithms.
  238.  
  239. What's new in 2.2?
  240. • The usual cleanups of course.
  241. • Substantially improved building of the index when an MPEG is opened. 
  242.     The new code is about five times the speed of the old code, and the 
  243.     interleaving of CPU and file access is done more carefully.
  244.     This should make windows popup more snappily when you open an MPEG file.
  245.     (Unfortunately if you're pulling the MPEG off a slow hard drive, CD-ROM 
  246.     or network this speed is limited anyway by the file system, not the CPU 
  247.     calculations.)
  248. • I should have had a TRY/CATCH handler in place for if an error occurred 
  249.     while the dialog boxes were being popped up for saving an MPEG or QT 
  250.     movie. This could have led to crashes (more likely just strange error 
  251.     dialogs), but is now fixed.
  252. • If you ran Sparkle in the background on an 8-bit color screen while a 
  253.     foreground app kept creating a number of different palettes, then when 
  254.     Sparkle was quit an error message could occur (I was running down an 
  255.     array associated with each new palette destroying items but I should 
  256.     have run down the array starting from the end not the beginning of the 
  257.     array.)
  258. • Thread synchronization is now done ``properly'' using a number of 
  259.     semaphores. This replaces the old method of using a very carefully 
  260.     orchestrated dance to move between threads. The new method is 
  261.     theoretically safer (and makes it a lot easier to alter the code) but 
  262.     being new I may have forgotten something in one routine or two. Bear 
  263.     with me and report any strange bugs---machine locking up, strange error 
  264.     messages, garbled images.
  265. • Some (very strange) QT movies may have multiple superimposed video tracks.
  266.     In this case when Sparkle created an MPEG or QT movie from the original 
  267.     QT movie parts of the image you saw could have random colors in them.
  268.     This is now fixed.
  269. • Other strange QT movies could be encoded with not a fixed frame rate but 
  270.     every frame lasting a different amount of time. When creating an MPEG 
  271.     nothing can be done about that, but when creating a new QT movie I allow
  272.     a frame rate of zero which will create all frames at whatever time they 
  273.     should be created at.
  274. • When a movie was being encoded to some other format the movie controller 
  275.      was not drawn with all decorations suppressed. Now it is.
  276. • When an MPEG window was opened said window displayed some flicker as pieces 
  277.     of it were drawn. This has been cleaned up. Likewise for PICT-sequence 
  278.     windows.
  279. • In a few places certain variables that should gave been initialized to NULL
  280.     or zero were not. In theory if an exception ocurred in these blocks of 
  281.     code a crash might occur. Anyway now fixed.
  282. • A bug in CustomGetFile() in the MacOS leads to a loss of 64 (or so) bytes 
  283.      every time a file selection dialog box is displayed if there is an `ictb' 
  284.      associated with the dialog box. (It looks like the `ictb' is read in and 
  285.      DetachResource'd() then the handle created that way is never disposed of.)
  286.      This was fixed by removing the `ictb's associated with these dialogs.
  287.     The same holds true for `mctb's if the dialog contains a popupmenu. I would 
  288.     guess it also holds for `cctb's, but it does NOT hold for `dctb's.
  289. • New look---windows with grey background, can shrink video as small as you like.
  290.     a startup splash screen.
  291. • If you decide partway through startup you don't want to run Sparkle, hit 
  292.     command-. (command-period) to abort.
  293. • PowerMac native (and very fast). A 6100/60 gives three times the 
  294.   playback rate of my Quadra 610.
  295. • Rewritten MPEG encoder to use way less memory.
  296. • MPEG decoding code has been restructured so as to present a block of 
  297.   code that can easily be dropped into other environments. This will form 
  298.   the basis for various QT components/drivers I'd like to write to give 
  299.   much tighter integration with QT.
  300. • All large memory allocation is done through temp mem. Basically this 
  301.   means you shouldn't ever need to increase the size of Sparkle's 
  302.   partition but you can open and save files limited only by all the 
  303.   memory on your mac.
  304. • Foundations have been laid for AppleScripting. You probably can't do 
  305.   any useful scripting with this release but that will change soon.
  306. • User interface has been tweaked a little. I hope you like the changes.
  307. • The most common problem with the 2.1 versions was that the preferences 
  308.   file would become corrupted leading to random errors. The prefs file 
  309.   handling has been changed in this version to make that much less likely.
  310.   If this release gives you problems, destroy the Sparkle prefs file then 
  311.   try again.
  312. • Many many bug fixes.
  313.  
  314.  
  315. What's new in 2.1.5?
  316. • Somewhere in the cleanups of code of the last few revs I landed up 
  317.     dividing some color motion vectors by two too often resulting in
  318.     misaligned color on MPEGs created without half-pixels. This is fixed.
  319.  
  320. What's new in 2.1.4?
  321. • Many many internal cleanups of the code as part of my cleanup for 
  322.     PowerPC. If these cleanups broke anything, please tell me.
  323. • There was in bug in some earlier versions so that when you opened Sparkle 
  324.     on a system without QuickTime rather than quitting gracefully it could 
  325.     crash when quitting. Now fixed.
  326. • Minor changes have been made to better support Macintosh Easy Open.
  327. • When saving an MPEG or QT movie in an alternative form the play button 
  328.     of the movie controller is hidden which I think looks better.
  329. • When a movie saving was in progress and was paused, if the relevant 
  330.     window was covered then uncovered (generating an update event)  
  331.     Sparkle would hang. This was because Sparkle tries to switch to 
  332.     a thread that has been put to sleep. This has been fixed.
  333. • If an MPEG were opened and immediately command-S were typed, once the 
  334.     saving was done it was possible for Sparkle to popup an error message.
  335.     The problem was that the very first update event for the MPEG window, 
  336.     used to initialize some variables, would be discarded is a save were 
  337.     begun immediately. The code used when an MPEG is opened has been fiddled
  338.     a little to prevent this.
  339. • I was asked by some people doing Sparkle for batch conversion of MPEG 
  340.     and QT for a way for Sparkle to indicate when it is done converting a 
  341.     file. I won't have AppleScriptability in place for a few months but I 
  342.     did put in a quick hack to allow this for users of QuicKeys. Look in the 
  343.     ReadMe 2nd file for details (do a search for QuicKeys). 
  344. • In the code I added to 2.1.3 to support halfPixels I made a typo which 
  345.     under rare circumstances would set the color of a block incorrectly or 
  346.     (if you were unlucky) crash. This is fixed.
  347. • Memory used for MPEG encoding MPEGs has been dramatically reduced. 
  348.     For the case of encoding MPEGs with only I-frames, the memory 
  349.     required is 1/6th of what was required in 2.1.3 and earlier versions. 
  350.     For MPEGs using P and/or B frames, memory required is about .4 of
  351.     what required earlier (actually 15/36). These memory requirements
  352.     will be shrunk further in later versions of the code.
  353. • The MPEG Playback prefs dialog has cleaned up a little and behaves a 
  354.     little more intuitively. Now the options under the 8bit color section 
  355.     always apply when the screen is 8bit color, regardless of the 8bit 
  356.     dithering method used.
  357.     There is now a tryout button. Click there to see how the changes you 
  358.     make alter what you see.
  359. • Two further options have been added to the MPEG Encoding dialog to give 
  360.     you a little more control over this behavior. 
  361.     You can now specify whether half-pixel encoding is used or not
  362.     (in the past half-pixels were always used).
  363.     Likewise you can specify whether or not to compare against raw 
  364.     reference frames or reference frames decoded from the MPEG stream being 
  365.     created (in the past decoded reference frames were always used).
  366.  
  367. What's new in 2.1.3?
  368. • There was a bug in 2.1.2 that prevented one (usually) from playing MPEGs 
  369.     in play all frames mode. So sorry about that. This is fixed.
  370. • I have (FINALLY) fiddled the P and B frame calculations to be EXACT at 
  371.     highest quality settings (ie when saving an MPEG to a secondary file.)
  372.     The last few touches involved doing all the finicky details specified 
  373.     in the MPEG DIS (which in the worst case can involve compositing a single 
  374.     image point from values spread over nine different places. The differences 
  375.     are very subtle but are visible---large areas of smooth texture in 
  376.     particular in the past tended to develop a slight granularity which is 
  377.     now cured.
  378.     This code involved coding a huge number of special cases and I may have 
  379.     made a mistake in a case or two. I have run all my example MPEGs through 
  380.     and they look good but if you see a block that looks misaligned or has a 
  381.     different color from what it should have, please tell me so I know I 
  382.     need to fix a mistake.
  383. • There was a bug in 2.1.2 and earlier versions where, if an MPEG was playing 
  384.     and you closed the window there was a small chance of an error message 
  385.     popping up. This bug was due to what's called a race condition. 
  386.     It should have been fixed, but if not please tell me.
  387.  
  388. What's new in 2.1.2?
  389. • In 2.1 when a window was first opened and the Video menu selected, the 
  390.     menu showed Palindrome looping as on even though it was not. This is fixed.
  391. • In 2.1 I had a serious (crashing) possible bug that could occur when a 
  392.     window was closed. This was because the life cycles of video encoding 
  393.     threads and video playing threads are different. I must rationalize 
  394.     these to one model, but till then I've applied a quick and dirty fix.
  395. • Long complicated pathways through about six auxiliary functions, used when 
  396.     threads died and a holdover from the Sparkle 1.x days, have been removed to 
  397.     use a much simpler virtual function based scheme. This is slightly faster
  398.     and, more important, much simpler hence, hopefully, less buggy.
  399. • Deactivating/activating of the ``Change file type to MPEG'' radio button in     
  400.     the open file dialog was a little erratic. This has been fixed.
  401. • Rudimentary balloon help has been added.
  402. • When memory is very low and a window starts being opened, but fails 
  403.       partway, the cleanup code was slightly wrong. Now fixed.
  404. • Improved the display on 4-bit color screens. It was very blocky.
  405. • Changed the progressbar to display properly on 4-bit color screens.
  406.     The two colors used for foreground and background were being mapped onto
  407.     the same color.
  408. • Change the progress bar to update itself better when parts of the window are 
  409.     uncovered. Before parts would be drawn quite a while before other parts
  410.     giving a result that looked silly.
  411. • Added a menu option to allow operation without ever yielding time to 
  412.     WaitNextEvent. If you don't need to give time to background applications, 
  413.     use this option for faster, less jerky, playback.
  414. • Speech manager code used to announce a delay when encoding an MPEG 
  415.     could, if timing was just wrong, crash. I think the problem was that the 
  416.     Speech Manager was building internal data structures on the stack, and 
  417.     that stack disappeared when the the MPEG encoding thread died. Anyway 
  418.     I've modified the speech code so this can't happen.
  419. • Discovered a serious problem in my video encoding code. When an MPEG 
  420.     window was resized while it was being converted to another MPEG or QT 
  421.     movie, the result could be a munged image for a few frames. The fix 
  422.     involved a major structural readjustment of Sparkle---ALL video 
  423.     manipulations now pass through ThreadEvent queues---but the result is 
  424.     that for the first time I feel confident about the theoretical 
  425.     underpinnings of Sparkle---that while minor bugs may remain, there are 
  426.     no conceptual nasties waiting to bite me.
  427. • When windows are resized, the resizing is done in a manner that leaves 
  428.     no gunk in the window in the moments before the resizing is complete.
  429. • I discovered yet another way in which things could crash---The MacOS call
  430.     DrawPicture() will crash if it runs out of memory---thanks Apple.
  431.     There's nothing I can do about this, so what I did do is try to trap 
  432.     situations that form a pattern of using DrawPicture() while memory is 
  433.     getting lower and warn you that memory is running low. This doesn't 
  434.     catch all situations but catches some.
  435. • The play/pause button no longer toggles between states when you start a 
  436.     movie saving or pause it. This is because what I was doing to get this 
  437.     to work in QT 1.x no longer works nicely in QT 2.0 --- flickering frames
  438.     result. I guess this is a consequence of DataPipe or something. 
  439.     Anyway I've replaced this with indicators in the title bar.
  440. • I made a few changes to allow easier more sensible playback of QT movies that 
  441.     consist of only sound. This is at present rudimentary but is a start.
  442.  
  443. What's new in 2.1?
  444. • Yet again memory management has been fiddled with. Previous tinkering with 
  445.     memory management was to ensure that my own code never crashed for lack 
  446.     of memory. Building on top of that, I've tried to ensure that calls to 
  447.     the operating system won't crash for lack of memory. This is more 
  448.     difficult because, obviously, I don't know just what the memory 
  449.     requirements of each call are. However I've done the best I can, and 
  450.     the resultant code seems even more robust than 2.02.
  451. • The scheduling has been revamped based on the threading. I now make 
  452.     intelligent decisions about which thread to schedule when. Also calls to
  453.     the main event loop, which were very expensive in time, have been cut 
  454.     dramatically. the result is about a 15% speed boost all round.
  455. • MPEG playback is now based on genuine timing, not on simply playing 
  456.     every frame as fast as possible. Like QuickTime movies, you can play 
  457.     MPEGs back in real time or play every frame. I also now support the 
  458.     movie controller variable speed controls obtained by control-clicking 
  459.     on the forward/backward stepper buttons.
  460. • You can now set QT and MPEG movies to loop.
  461. • You can now grow or shrink MPEG and QT movie windows.
  462. • The cursor is now hidden when movie playback starts, until you move it.
  463.     This seems to be a reasonable compromise for preventing flickering cursor
  464.     when starting a movie using the keyboard, but atill allows the user 
  465.     easily to find the cursor when needed.
  466. • When files are opened, windows are now tiled in a vaguely intelligent fashion,
  467.     attempting both to use the available screens with best depth, and to 
  468.     avoid window overlap.
  469. • Dragging windows is now aligned to a grid of optimal window placement. This
  470.     gives better movie playback.
  471. • Can now show/hide the progressPane, movie controller and frame count with the 
  472.     tab key using tab, shift-tab, control-tab.
  473. • The drawing of the progress bar has been altered slightly, to fix cosmetic 
  474.     defects and to make the appearance closer to that of the movie controller.
  475. • Support for MPEGs with a pixel aspect ratio not equal to one has been added.
  476.       At present this isn't switched on because some dumb MPEGs out there 
  477.       have a bogus aspect ratio encoded in them. However if someone wants 
  478.       this feature right away, I'll add a user interface to access it.
  479. • Support for MPEGs with multiple sequence headers has been added, not 
  480.     that I have ever seen such an MPEG.
  481. • Playback is now much faster through a variety of mechanisms. However 
  482.     this has, as a consequence, lower quality playback. You may set through 
  483.     preferences which optimizations you're willing to accept for faster 
  484.     playback and which you're not willing to accept. All optimizations are 
  485.     turned off when converting an MPEG to another format so that you'll get 
  486.     the best possible quality.
  487.     Playback speed is now about 1.6 times faster for 24 bit screens, about 
  488.     2.5 times as fast for 8 bit grey screens, and improvements in between for 
  489.     other screen depths.
  490. • Special purpose display code is used for 
  491.     24 bit, 16 bit and 8 bit color screens and 8 bit grey screens.
  492.     All other screens are sent through one of the above special purpose codes 
  493.     then use QuickTime to convert the pictures to the appropriate screen depth.
  494.     Obviously special purpose code is faster. If I get lots of calls for 
  495.     screen depths other than the one's I'v supported directly, I'll look into 
  496.     adding more special purpose code.
  497. • In 2.0 I broke the support for adding files called name.mpg, but without 
  498.     a file type of MPEG so you could open files of that type but nothing 
  499.     would happen. Sorry about that. It's been fixed. 
  500. • When files are opened and are not of the default Mac types (for example 
  501.     files imported from a UNIX box, or files on a PC CD ROM) Sparkle uses 
  502.     more intelligence in deciding whether to open these files as MPEGs, QT 
  503.     movies or pictures. If this mechanism is still not general enough for 
  504.     some users (I image mainly users sharing data with PCs), let me know.
  505. • The ``official'' MPEG encoding pattern of IBBPBBPBBPBB is now a pre-defined 
  506.     option. Some people asking for this as a pre-defined option have given me
  507.     slightly different patterns as the ``official'' pattern. However what I 
  508.     have used is, to the best of my knowledge correct, and I'm assuming these
  509.     people who wrote to me simply made typos. If you have comments on this, 
  510.     please mail me.
  511. • I twiddled the RGB to YCrCB conversion code that is the first step in 
  512.      encoding MPEGs. The changes won't affect anyone except people creating 
  513.      MPEG movies whose width or height is odd, in which case the very last 
  514.      row or column of pixels will have more accurate color. The important 
  515.      change, however, was that I no longer read beyond the end of some arrays,
  516.      so I'm ready for when Apple give us protected memory a year from now.
  517. • Under certain rare circumstances, depending on the number of frames int the 
  518.     input file and the IPB pattern used, the last frame or two of the input 
  519.     would not be saved in the output MPEG. This is fixed.
  520. • MPEG encoding now can specify a frame rate (in the past this was always 
  521.     30 fps). Sure the range of choices is limited---blame the people who 
  522.     wrote the MPEG spec---those are, basically, the only choices.
  523.     1) Can people with MPEG hardware verify that this works for me?
  524.         On my mac with 10fps max playback, it's tough to see if this works.
  525.     2) There are some frame rates I've omitted that are very close to those 
  526.        I give, for example 29.97 fps. At some point i'll get the finicky 
  527.        time right to support these but it's a pretty low priority compared 
  528.        to sound.
  529.  
  530. What's new in 2.01?
  531. • Implemented padding YUV macroblocks with a repeat of the last value of
  532.      each YUV triplet when macroblocks at the edge of a frame spill over 
  533.      the edge. The most common case of this is a 120 pixel high movie with a 
  534.      macroblock height of 128. In the past this spillover was filled randomly.
  535.      The result of this is that MPEGs created are about 15% smaller.
  536. • Some diddling with the code used by the IDCT algorithm gives a speed boost 
  537.     of about 5% to both playing and encoding MPEGs.
  538. • Fixed a serious bug that prevented you from playing an MPEG if you started 
  539.     playing    it then interrupted it. A nice byproduct of this is that I got 
  540.     jogging of MPEGs fully operational. You can now repeatedly view a section 
  541.     of the MPEG by hitting command-right-arrow then command-left-arrow to keep 
  542.     the MPEG moving forwards then backwards.
  543. • Altered the alert popped up when the Thread Manager is not present to make
  544.     it more palatable to corporate and institutional users.
  545. • Fixed the MPEG buffering which would give problematic results for very small
  546.     MPEGs (say three frames or less).
  547. • Finally went through all resources, marking them purgable or not and removing
  548.     the unnecessary ones.
  549. • Fixed the "PBBIBB" default frame set to make it correspond to the user view
  550.     of things, not my programmer's view.
  551. • Fixed a bug that prevented a temporary movie created by the movie controller 
  552.     handling an MPEG file from being destroyed.
  553. • Fixed two bugs in the Think Class Library dealing with the loading of dialogs 
  554.     then manipulating them without setting their memory blocks to non-purgable.
  555. • Fixed a long-standing bug in the MPEG player buffer-handling code that 
  556.     would cause the MPEG frame index to be incorrect if it was created while 
  557.     memory was short. This probably never caused problems except for very long
  558.     MPEGs.
  559. • When converting a QT movie into a different movie form, the dialog that comes
  560.     up asking you for compression options will have the frame rate and key
  561.     frame rate set at what the original movie used, sparing you from having to
  562.     guess. I will eventually have this working across all file conversions, 
  563.     not just movie-->movie.
  564. • The Think C 6 compiler contains a bug when performing code-motion optimization 
  565.     on complex loops. If you run through the assembly it produces in this case,
  566.     it performs some very nifty register coloring and creating induction 
  567.     variables for the loop. It then leaves out one crucial instruction to 
  568.     update one of the induction variables each pass through the loop and so 
  569.     the code is garbage. 
  570.     As far as I can tell, this only affects one function in my code and I have
  571.     used a #pragma there to prevent it happening, but the fact that bugs like
  572.     this exist in the compiler is a little worrying.
  573. • Revised all memory allocation so that it is more likely to not to use up all
  574.     memory reserves and leave nothing for toolbox.
  575. • Found an especially nasty bug involving grabbing frames from a QT movie 
  576.     which, when memory ran low, would leave the system GrafPort/GDevice 
  577.     environment in an inconsistent state.
  578. • Revised all uses of GWorld to use tempMem, but fallback to local heap if 
  579.     tempMem is unavailable.
  580. • Altered the strings used to popup error messages at startup if QuickTime 
  581.     is not available. These got mixed up when I moved code around.
  582. • The code to build the MPEG index when an MPEG is opened would run out of space
  583.     when a very large MPEG was opened---one of a thousand frames or more. Now 
  584.     memory is allocated for this a little more flexibly.
  585. • Fixed a bug I inserted when I changed from Sparkle 1.6 to 1.7. I rewrote the
  586.     Berkeley motion vector code to speed it up and in the process made one 
  587.     little typo, shifting a variable right by 1 not 2. The effect of this, in 
  588.     Sparkles 1.7 and 2.0 was that, under very rare occasions, blocks of color 
  589.     would appear a few pixels off from where they should be. The only place I 
  590.     ever saw this was three or four frames of the MPEG sales110.mpg.
  591.     This is not related to a separate problem. 
  592.     The motion estimation code in the MPEG encoder (at present the Berkeley code
  593.     with practially no changes) is not perfect. It sometimes creates 
  594.     blocks that appear to be wildly off from where they should be (by quite a few
  595.     pixels). This is not very obvious in real life, but is very obvious in animation.
  596.     This is largely a quantization artifact---it goes away if you lower the 
  597.     quantizations. But obviosly you don't want to do that always, just where 
  598.     necessary, so you really want a smarter quantizer that is adaptive. 
  599.     I'll work on issues like this as soon as I can.
  600. • When converting a movie with sound to MPEG or QT, occasionally pops of sound could 
  601.     be heard. This is fixed.
  602. • When converting movies with very low keyframe rates (say 20 or more dependent 
  603.     frames per keyframe) occasionally the display of the movie would get confused 
  604.     and appear to alternate between two different frames. This is fixed.
  605.  
  606. What's new in 2.0?
  607. • The structure of the code has been completely altered to be based on 
  608.     threads. This makes it much easier for me to add new features to the code 
  609.     while having it retain MultiFinder friendliness.
  610. • Now opens and plays QT movies.
  611. • Now can create MPEG files. General conversion from 
  612.      {QT or MPEG}--->{QT or MPEG} is possible.
  613. • Many minor changes to the way files are opened, named and such.
  614. • Makes minor use of the speech manager if installed.
  615. • You can now play MPEGs backwards.
  616.  
  617. What's new in 1.71?
  618. • The progress bar now updates itself properly at the very end of saving 
  619.     each frame to Quicktime. It also draws itself better on b/w screens.
  620. • More of the default QT movie player keystrokes now work.
  621. • The app notes if an MPEG file has many errors and if so warns you that 
  622.     it has probably been transferred to the mac incorrectly.
  623. • I have incorporated a workaround to make Sparkle work with the QT VM 
  624.     extension. However I do not recommend you use the two together. If you do 
  625.     use QT VM you will find Sparkle's memory usage a little less efficient 
  626.     than without using QT VM. This is because of the way QT VM works.
  627. • Fixed a bug that caused unusually sized MPEGs to display as distorted.
  628. • Sparkle should now cope a little better with low memory situations.
  629. • Added a small tweak to improve drawing on 16bit screens under low 
  630.     memory conditions.
  631. • Uses the most recently released version on the floating windoid.
  632. • I have learned of an app that will convert QT to MPEG on the mac. It's 
  633.     not the easiest thing to use and I recommend this only for people 
  634.     who really need this, not for people who just want to play around.
  635.     See the README file for details.
  636.  
  637. What's new in 1.7?
  638. • Opening files is much faster.
  639. • Fixed the size of the checkboxes in the Open File dialog to the correct 
  640.     size for all those millions of people who use Chicago as their system 
  641.     font cause they have no sense of aesthetics. Oops.
  642. • Now when Sparkle changes the file-type of an file, the Finder will update 
  643.     the icon immediately, instead of forcing you to open and close the 
  644.     folder to see a new icon. Thanks to Jamie McCarthy for telling me how 
  645.     to do this.
  646. • Added an "About Sparkle" dialog box to quieten the constant stream of 
  647.     complaints about this.
  648. • Changed the way progress is reported. I think the new scheme feels 
  649.     rather more elegant. (If you have a fast machine and only use small 
  650.     MPEGs, you may not notice this change much.)
  651. • Adde random access. You can now use the step backward stepper, or 
  652.     simply click in movie controller where you want to go. All standard 
  653.     movie controller clicks and keystrokes are supported.
  654. • Restructured the internal code vastly. This is what took most of the 
  655.     time and while it doesn't directly help you users, it gives me
  656.      a framework that's much easier to build on. For example it should be 
  657.      trivial to add Apple Event support when I get round to that.
  658. • Three or four minor bugs were squelched, mostly involving Sparkle crashing
  659.      when it encountered MPEGs with invalid data in them.
  660. • Now quits gracefully when started on a 68000 mac like a Classic, rather 
  661.     than crashing. I'm sure    lots of people care about this.
  662. • Added better multi-tasking support. This takes two forms. 
  663.     One is that the length of the timeslices Sparkle uses before giving up 
  664.     the CPU are now absolute times.  Before they were numbers that worked 
  665.     well for my SE/30, but probably not optimally for slower or faster 
  666.     machines.
  667.     The second is that you can now context switch out of Sparkle while it 
  668.     is doing slow QT conversions (especially converting to Compact Video).
  669.     The way I have implemented this is not wonderful, but the best I can 
  670.     do given the present way the code is structured. The next version 
  671.     will use the Thread Manager and will do this rather better.
  672.     This second form of timeslicing is done through the 
  673.     SetSequenceProgressProc() call which is new in QT1.6 and which is why 
  674.     I now require use of QT1.6. Also QT does not yield the CPU very often,
  675.     and (as far as I know) there is no way to make it yield more often.
  676.     So while your machine is no longer completely frozen as it does its
  677.     conversion, it's still not too pleasant to use for typing. I can't do 
  678.     much about this---complain to Apple and tell them to change this part of 
  679.     QT, or better yet the whole OS.
  680.  
  681. What's new in 1.6?
  682. • I became tired of continually having to explain to people about mac 
  683.     file types, so I wrote a file filter function for the Open File dialog 
  684.     box which displays ALL files with a .mpg suffix. This should make use a 
  685.     lot easier for novices.
  686. • Fixed a bug that involved writing to NULL.
  687. • Fixed a bug that prevented IBP type MPEGs from rewinding when they 
  688.     reached the end and the play button was hit twice.
  689.  
  690. What's new in 1.5.2?
  691. • I was disposing of a handle twice (specifically I was disposing of a 
  692.     pixmap and then its colortable, not realizing that DisposPixMap took 
  693.     care of the colortable for me.) Thanks to Dan Sears for pointing this out.
  694.     I never noticed a problem due to this bug, but it's probably good to 
  695.     have killed it.
  696.  
  697. Whats new in 1.5.1?
  698. • One part of my speed optimizing code was not being initialized properly. 
  699.     This caused a very specific type of MPEG file to show parts of its first 
  700.     frame as greenish blobs. Now fixed.
  701. • The code to detect errors in a corrupted MPEG file has been made even 
  702.     more robust. Substantially better recovery from such errors, by 
  703.     rebuilding the lost parts of a frame from the previous frame, has been 
  704.     introduced. Thanks to a wonderfully corrupt MPEG file I pulled off 
  705.     usenet with about 15 misc errors in it for pointing out new and 
  706.     ingenious ways to fail.
  707. • New icons, courtesy of Richard Lim in Britain. I hope you like them.
  708.     You will have to rebuild the desktop to see them.